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RETURN AUTHORIZATIONS 

If for any reason, warranty repair, updating, etc., any material 
isto be returned, a Return Authorization (RA) must be obtained 
from Compucolor Corporation, (404)449-5996, Compucolor 
Corporation will not accept any collect or COD deliveries. 

LIMITED WARRANTY 

Replacement of defective or faulty parts within 90 days of 
delivery, at Compucolor Corporation. 

THIS WARRANTY SHALL BE EXCLUSIVE AND IN LIEU 
OF ANY WARRANTY OF MERCHANTABILITY FITNESS 
FOR A PARTICULAR PURPOSE OR OTHER WARRANTY 
OF QUALITY EXPRESS OR IMPLIED. 

LIMITATION OF WARRANTY 

Manufacturer shall not under any circumstances be liable for 
special or consequential damages. EXCLUSIVE REMEDYfor 
liability of manufacturer whether based on contract, negli- 
gence, strict tort, or breach of warranty shall be limited to 
price of goods upon which such liability is based. 



IMPORTANT NOTICE ON SOFTWARE 

ALL COMPUTER PROGRAMS ARE DISTRIBUTED ON AN 
"AS IS" BASIS WITHOUT WARRANTY Compucolor Corpo- 
ration shall have no liability or responsibility to customer or 
any other person or entity with respect to any liability, loss or 
damage caused or alleged to be caused directly or indirectly 
by computer equipment or programs sold by Compucolor 
Corporation, including but not limited to any interruption of 
service, loss of business or anticipatory profits or conse- 
quential damages resulting from the use or operation of such 
computer or computer programs. 

NOTE: Good data processing procedure dictates that the user test the program, run 
and test sample sets of data, and run the system in parallel with the system 
previously in use for a period of time adeduate to insure that results of 
operation of the computer or program are satisfactory 

THE FOREGOING IS AN ABBREVIATED STATEMENT OF LIMITED WARRANTY 
AND LIMITATIONS OF LIABILITY COMPLETE STATEMENT CONTAINED ON 
SELLERS ORDER CONFIRMATION FORM MUST BE READ FULLY BY PUR- 
CHASER AND FAILURE TO OBJECT WITHIN 10 DAYS AFTER RECEIPT OF 
ORDER CONFIRMATION SHALL CONSTITUTE ACCEPTANCE OF WARRANTY 
AND LIABILITY CONDITIONS 
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Instruction Manual 



The Compucolor Corporation thanks you for purchasing a 
Compucolor II. Although many precautions have been 
taken to assure that this material is received in good 
condition, we ask that you take a few minutes to read the 
following material so that you may derive maximum enjoy- 
ment and use from your Compucolor II. 

The handbook has been divided into six sections. 
Section One gives directions for operating the Compu- 
color II and describes a step by step procedure for loading 
a program into the Compucolor II from a diskette. Section 



Two describes the keyboard and tells you how to write and 
expand a simple program. Section Three summarizes 
BASIC and various FCS and CRT commands. Section Four 
concerns handling and care of diskettes as well as other 
precautions. Section Five lists a variety of books on the 
market that deal with computers and programming. 
Section Six provides lists of port assignments, memory 
locations, the fifty pin bus and RS232C Interface, as well 
as a complete character set. 
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Section I 

How to operate the Compucolor II 

1 . Place the Compucolor II in a convenient location remembering that you will probably enjoy sitting and playing games on 
the computer for hours at a time. Be careful not to obstruct the air flow through the vent on the back of the unit. 

2. Now connect the keyboard cable to the socket labeled "Keyboard" on the back of the Compucolor II. This connector 
will only fit one way, so if it doesn't fit, turn it over and try pushing in without forcing it. Find the CAPS LOCK key to the 
left of the space bar on the keyboard. Make sure this key is in the down position (see page 4). 

3. Next plug the power cord into the back of the computer much like you would plug in an electric frying pan. Then plug the 
other end of the power cord into the wall socket. You may need an adapter if your socket cannot take a three-prong insert. 

4. It's now time to turn on the Compucolor 1 1 by pushing to one side the "Power" (white) button on the back of the unit, 
just above the cord. 

5. The Compucolor 1 1 will require 60 seconds for the tube to warm up before the message "DISK BASIC 8001 V6.78 
COPYRIGHT© BY COMPUCOLOR" will appear 

6. If it does not appear then hold the SHIFT and CONTROL keys down and press the CPU RESET key (Note: leave the 
SHIFT and CONTROL keys down for at least 5 seconds after pressing 

CPU RESET key) 

7. Take the diskette that came with your Compucolor 1 1 and slip it into 
the right side of the computer. Make sure the diskette is inserted 
correctly and then close the door. See illustration. 

8. Push AUTO (brown key in upper left hand corner). 

9. You will see a list or "MENU" of programs on the screen. Select the 
program by the number at left. Type in the number and press the 
ENTER key 

10. The program you selected will be loaded into the Compucolor II and 
you will see directions on the screen on how to proceed with the 
program you selected. Have fun. 

1 1 . If nothing appears on the screen after pressing AUTO key try turning 
the diskette over and follow the instructions starting at step 6. 

12. If it still doesn't work after trying it again, then simply press the CPU 
RESET key with no other keys held down. The display will now say, 
"COMPUCOLOR II CRT MODE V6.78." If this does not appear turn 
the unit off for i 5 seconds and then try from step 4. 

13. After the "COMPUCOLOR II CRT MODE" message appears, press 
the (ESC) key and the (BASIC) or letter W key The following message 
should appear: "DISK BASIC 8001 V6.78 COPYRIGHT© 
BY COMPUCOLOR." "MAXIMUM RAM AVAILABLE?" 

Now type "8192" and press the ENTER key (If your Compucolor 1 1 is a Model 4 type "16384," then ENTER. If a Model 5, 
type "32768" then ENTER.) The unit will come back with the amount of free RAM memory available and the "READY" 
message. Now go to step 7. NOTE: if the ENTER key is pressed without entering a number the unit will search for the 
maximum RAM in your Compucolor II. 

1 4. If the above does not provide the required results contact your local dealer for assistance, or call Compucolor Corpora- 
tion's toll-free HOT LINE: (800) 241-4310. 




Section II 

Computer Basics 

Compucolorll is a microcomputer. Housed within your 
Compucolor II is a single integrated circuit chip called a 
microprocessor This is the very heart of your Compucolor 
II. The microprocessor is the computing device for storing 
programs and for performing logical operations. The micro- 
processor, called the Central Processing Unit, or CPU, 
controls all operations of the Compucolor 1 1. 

Compucolor II is capable of storing and filing informa- 
tion. Data is fed into the computer by means of typing on 
the keyboard. This process called INPUT uses the keyboard 
as its device. To view what has been fed into the computer, 
Compucolor II uses a display screen called a cathode-ray- 
tube or CRT display unit, to show OUTPUT 

As soon as your Compucolor II is turned on, you are 
ready to play games, program, store and retrieve informa- 



tion. You are in "DISK BASIC 8001 ." If you followed the 
instructions on page 2 of this manual you were able to load 
a diskette and run a program. Now we'd like to re-introduce 
you to your Compucolor 1 1 so that you can communicate 
with it effectively. 

Compucolorll has within itawell defined set of rules 
for communicating with you. Your task is to learn what the 
computer already knows. Together, you and Compucolor 1 1 
will communicate in such a way that Compucolor II will do 
as you say. 

Communicating with Compucolor II means that you 
will be feeding data or information into your unit by means 
of a KEYBOARD. Let's take a few minutes to talk about 
some of the keyboard's features. 
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Keyboard Operation 



CAPS LOCK 

Typing words on the 
Compucolor II is only 
done in capital letters. 
To facilitate the use 
ofcapitals, aCAPS 
LOCK key is used. 
Located on the left 
next to the space bar, 
the CAPS LOCK key 
will stay depressed 
and all letters typed 
will be capitals. By 
using the SHIFT key, 
special characters can 
be printed while the 
CAPS LOCK key re- 
mains depressed. To 
unlock the CAPS 
LOCK key, depress it 
once. The key is now 
flush with the space 
bar and special char- 
acters are now typed 
when the SHIFT key is 
not depressed. With 
the SHI FT key de- 
pressed capital letters 
are typed. The num- 
bers and punctuation 
keys work the same as 
a regular typewriter. 
SHIFTgivesthetop 
character on a key 
and unshift gives the 
bottom character on 
a key. 



SHIFT KEY 

Compucolor M's key- 
board is much like an 
ordinary keyboard 
with some additions. 
Like a regular type- 
writer, the SHIFT key 
is used to type upper 
case characters and in 
some cases, special 
characters. The 
SHIFT key must be 
depressed until the 
desired character is 
typed. 



AUTO 

The AUTO key on the 
upper left has been 
specially programmed 
so that when you press 
th eAUTOkevapiiQ ^ 
g ram callei l:IM£N.U- 
_BAS"w ill be loaded 
from the diskette and 
caused to run. It will 
list on the screen all 
programs that can be 
run under the 
"MENU" system. 



The following keys 
must be depressed 
while the desired key 
is being pressed: 

CONTROL 
SHIFT 
REPEAT 
[COMMAND] 

The following key 
need only be pressed 
and then followed by 
pressing the desired 
key: 

(ESC) 



RETURN 
ENTER 

The RETURN-ENTER 
key is on the right side 
of the keyboard. By 
pressing this key when 
you are in DISK 
B AS I C you com mand 
the Compucolor II to 
accept the most recent 
instruction entered. If 
you are in the "CRT 
MODE'' thenthlswilL 
o nly cacTse a carriage 
Tgu rn as on a. 
typewriter. 
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DIRECTION 
ARROWS, 

HOME 

Three direction 
arrows and a HOME 
key are located on the 
right side of the 
keyboard. The HOME 
key and the arrow 
keys control the 
cursor. Pressing 
HOME brings the 
cursor to the upper 
left hand of the 
screen. The direction 
arrows are used for 
correcting typing 
mistakes or to carry 
you to another spot 
on the screen. 

To correct a typing 
error in DISK BASIC 
press the <- arrow 
until you have erased 
the error. This back- 
space key erases all 
letters, one at a time, 
that it touches. For 
example, if you had 
typed "NOW IS THE 
TYM E"<- ^ <- retype 
"IME:' 
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ERASE PAGE 

To clear the screen 
press the ERASE 
PAGE key. This will 
return the cursor to 
Its home position and 
you are ready to start 
again In the CRT 
mode. NOTE: In DISK 
BASIC mode It has 
erased the screen, 
but It did not erase 
your BASIC command 
Internally. 



REPEAT 

The REPEAT key 
next to the space bar 
allows you to type 
one letter again and 
again by typing a 
letter and holding the 
REPEAT key down at 
the same time. 



CPU RESET 

The CPU RESET key, 
on the far right of the 
keyboard, when 
pressed, takes you out 
of the DISK BASIC 
mode and puts you 
Into the CRT mode. 
The ESCAPE key 
(ESC), located directly 
below the AUTO key 
(top left) permits you 
to go into various 
special modes by 
pressing (ESC) and 
the desired code key. 
The keys with a name 
enclosed within ( ) 
are standard escape 
codes. A detailed 
listing of these codes 
can be found In 
Section III. 



ATTN/BREAK 
(Attention/Break) 

KEY 

To temporarily sus- 
pend operation when 
running or listing a 
BASIC program, press 
the BREAK key. 

To continue, press 
RETURN or any other 
character except i,. 

The 4, or line feed 
will cause BASIC to 
break and halt 
operation. 

Use i followed by 
RETURN to break 
out of an INPUT 
statement In BASIC. 
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NOTE: There is a 
difference between the 
number Q and the letter 
O, and between the 
number 1 and the letter 
L on all computer 
keyboards. 



What is a Program? 

A series of instructions, stored by the computer is called a program 

nf thi/naSft''® written in a simple language called BASIC. The computer already knows this language and with the help 

of this pamphlet, you will learn some of the BASIC language in order to communicate with Compucolor II 

LGT S DGQin. 

You're about to write a simple program. 
First: Press CPU RESET key while holding down the SHIFT key and the CONTROL key 
Screen display will look like this: 

DISK BASIC 8001 V6.78 COPYRIGHT © BY COMPUCOLOR 
MAXIMUM RAM AVAILABLE? 
7473 (or 15665, or 32049) 
READY 

Now type: 

10 PRINT "HI! THIS IS THE START OF SOMETHING WONDERFUL!" 
Recheck your typed statement. 

1 . If wrong, use^ key (backspace) to retype. 

2. If correct, press ENTER key. 

3. Type RUN and then press the ENTER key. 

4. If you get an ERROR message, retype the whole line, beginning with 10. 

5. Press the ENTER key 

6. Type RUN and then press the ENTER key 

Did Compucolor follow your instructions? 

Congratulations! You have justwritten your first program! 

True, it's only a one-liner, but it is the start of something wonderful! 



HIGHLIGHTS 

In writing a program every line must have a number. The program is listed on the screen in numerical order, 
from the smallest to the largest number 

Always use the numeral £f to type your program numbers. The letter O cannot be substituted for a number 
Type PRINT: The computer will print everything that is included within the quotation marks. 
Press ENTER: This is a command that tells Compucolor II to remember the most recent instruction entered. 

J^'^^?,yyi,^"y *ii^? y°" "'^"* Compucolor 1 1 to follow your instructions, you must type RUN and then press 
the ENTER key This causes the Compucolor II to execute the RUN command. 



Programs can be expanded. 

In the last section you wrote a one-line program. By adding a second or third line, your program can be expanded. 

Type 

20 PRINT "CAN YOU BELIEVE THAT I CAN WRITE A PROGRAM?" 
Check your work for errors. 

Press ENTER. 

Type RUN and then press the ENTER key. 
If all systems worked, the screen display should read: 

THIS IS THE START OF SOMETHING WONDERFUL! 

CAN YOU BELIEVE THAT I CAN WRITE A PROGRAM? 
Let us assume that you want to answer the above question- 
Type YES. 

Hit ENTER. 

Screen display now reads: 

SN ERROR. 
SN ERROR is the computer's way of telling you that it is not programmed to understand your message. Unless the com- 
puter gives you a choice between YES and NO, you cannot enter YES. Sometimes SN ERROR appears even if you do not 
intentionally enter misinformation. 

Type LIST, press ENTER. Behold! The computer has followed your command and has listed everything that you have 
written. 

IF YOUR LISTING HAS A MISTAKE 

When you find a mistake, type the number of the line that has the mistake in it. Then retype it correctly and press ENTER. 
The computer will now incorporate this new line into the program and the original line will be taken out automatically 

SN ERROR 

The computer's way of telling you that it cannot understand your message. 

LIST 

This allows you to see what you have written up to this point. 

REMEMBER 

Do not press SHIFT key Letters are printed in capitals. Hold SHIFT key down to get special symbols. 

Usually the line numbers in a progl-am are written 10 numbers apart. This numbering system permits you to add new in- 
formation to your program. Sometimes it is easier to read a program output when there is a space between the lines. To put 
a space between your program lines- 
Type 15 PRINT 

Press ENTER 

Type RUN 

When you type PRINT and write nothing after it, the computer will do just that— it will print a blank line. Pretty neat! 

By adding additional numbers and statements, you can expand your program further. Just type in the number and the 
computer will automatically put it in the correct numerical sequence. 

Now that you have taken part in the excitement of programming, you might want to find out more about it. Section 5 of 
this handbook lists some books on programming and games that might interest you. 



HIGHLIGHTS 

1 ) Order 

2) RUN 

3) SN ERROR 

4) LIST 

5) SHIFT key 



Section III 

Summary of Commands 



1. CRT COMMANDS 

CONTROL CODES 



CODE 



EXPLANATION 



0-NULL (control®) 
1 -AUTO (control A) 
2- PLOT (controls) 

3-CURSOR XY (control C) 

4— (control D) 
5 -(control E) 
6-CCI (control F) 

7-BELL (control G) 

8- HOME (control H) 

9-TAB (control 1) 

10— 4/ (control J) or 
LINEFEED 

11 -ERASE LINE (control K] 

12-ERASE PAGE (control L) 

13-RETURN (control M) 

14-A7 ON (control N) 
15- BLINK/ A7 OFF (control O) 
16-BLACK KEY (control P) 
17-RED KEY (control Q) 
18-GREEN KEY (control R) 
19-YELLOW KEY (control S) 
20-BLUE KEY (control T) 
21 -MAGENTA KEY (control U) 
22-CYAN KEY (control V) 
23-WHiTE KEY (control W) 
24-XM IT (control X) 

25-CURSOR RIGHT (control Y) 

26-CURSOR LEFT (control Z) 

27- ESC (control [) 

28-CURSOR UP (control \) 
29-FG ON/FLAG OFF (control ]) 

30- BG ON/FLAG ON (control A) 

31 -BLINK ON (control -) 



Has no effect. 

Loads and runs a BASIC program named "MENU," from the disk drive. 

Enters grapliic plot mode (see plot submodes), not allowed as a BASIC input 
character 

Enters X-Y cursor address mode for either visible cursor or blind cursor, used to go 
from BASIC to CRT MODEwhen typed as a BASICinput character 

Not used. 

Not used. 

The next character which follows provides the 8 bit visible status word. Specifies 
Foreground, Background, Blink, and Plot. (See status word format, page 9.) 

Not used. 

Moves the cursor to top left corner of display. 

Causes cursor to advance to next column— the tab columns are every 8 characters. 

Causes a break in BASIC execution of a program, causes the cursor to move down 
one line. 

Causes the cursor to return to beginning of line and causes the complete line to be 
erased. Also causes the BASIC input line to be ignored. 

Causes the complete screen to be erased and the cursor moves to the home position. 
BASIC input ignores this character 

Causes the cursor to move to the beginning of the line it presently is on. Causes 
BASIC input to accept the typed line and process as a statement or input data. 

Turns the A7 flag on. (2x character height and also 1 stop bit.) 

Turns the blink bit and A7 flag off. 

Sets foreground color black if flag is off and background black if flag is on. 

Same as above with colorred. 

Same as above with color green. 

Same as above with color yellow. 

Same as above with color blue. 

Same as above with color magenta. 

Same as above with color cyan.. 

Same as above with color white. 

Causes data to be transmittea from the visible cursor to the end of the page or until 
FF, 00 sequence is found in refresh RAM. Sends text characters with a linefeed and 
carriage return at end of each line. NOTE: color status is not sent. 

Causes the cursor to move right 1 position. On BASIC input displays previous 
character inputted. 

Causes the cursor to move left 1 position. On BASIC input deletes previous character 
from input buffer 

Provides an entry to the escape code table— must be followed by one or more codes 
for proper operation. 

Causes the cursorto move up one line. 

Sets the flag bit off. If followed by one of the color keys it will set the foreground to 
that color In plot mode OR's "ON" bits. 

Sets the flag bit on. If followed by one of the color keys, it will set the background to 
that color In plot mode XOR's "ON" bits. 

Sets the blink bit on which will blinktheforeground color against the background 
color. 
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ESCAPE CODES 



5 BIT CODE 



LETTER 



FUNCTION 
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Used for terminal control— not available for any other use. 

Blind cursor mode. 

Plot via color pad. 

TransmitcursorX.Y position to RS232 PORT. 

Enters Disk File Control System (FCS) with CRT as output. 

Re-entry to DISK BASIC. 

Sets full duplex mode, not functional when in BASIC. 

Enters Disk File Control System (FCS) with RS232 PORT as output. 

Sets half duplex mode. 

Causes a program jump to location 36864. 

Sets write vertical mode. 

Sets roll up and write left to right mode. 

Sets local mode. 

Sets all output to the RS232 PORT. 

Sets to ignore all inputs. 

Not used. 

Not used. 

Not used. 

Baud rate selection mode. A7 on = 1 stop bit, A7 off = 2 stop bits. (See baud rate table.) 

Causes a program jump to location 40960. 

Causes a program jump to location 33280. 

Not used. 

Not used. 

Initializes and transfers control to DISK BASIC 8001. 

Sets terminal to page mode and write left to right mode. 

Test mode— fill page with next character 

Not used. 

Visible cursor mode. 

Not used. 

Not used. 

Causes a program jump to location 33275. 

Transfer control to the CRT mode. 



BAUD RATE SELECTION 
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STATUS WORD FORMAT 
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GRAPHIC PLOT SUBMODES 



DISK BASIC plot value 

or 
RS-232 INPUT CODE 



255 
254 
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250. 
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PLOT 
SUBMODE 



OPTIONAL 

FUNCTION 

KEYBOARD CODE 



Plot Mode Escape 
Character Plot 
X Point Plot 

Y Point Plot 

X-Y Incremental Point Plot 
Xo of X Bar Graph 

Y of X Bar Graph 

X max of X Bar Graph 
Incremental X Bar Graph 
Yo of Y Bar Graph 
X of Y Bar Graph 

Y max of Y Bar Graph 
Incremental Y Bar Graph 
Xo Vector Plot 

Yo Vector Plot 
Incremental Vector Plot 



F15 

F14 

F13 

F12 

F11 

F10 

F9 

F8 

F7 

F6 

F5 

F4 

F3 

F2 

F1 

F0 



For incremental plot submodes see the format of the incremental direction codes {page 9). 



2. DISK BASIC 

BASIC Statements 

The following summary of BASIC statements defines the general format for the statement and gives a brief explanation 
ot Its use. 



COMMAND 

^CLEAR 

^LEAR X 

VCONT 

^/ DATA value list 

vDEF FN X (argument) = 
expression 

^DIM variable (n), variable (n,m), 
variable $(n), variable $(n,m) 

x/eND 

FILE"N", "filename", records, 
rec. size, blocking factor 

FILE "R", file number, "filename", 
buffers 

FILE "A", file, current rec, records, 
rec. size, blocldng factor 

FILE'C", file 1,—, file N 

FILE"D", file 1,—, file N 

FILE"T", line number 

FILE "E", file, error, line number 

^FOR variable = expression 1 TO 
expression 2 STEP expression 3 

/get file N, record, first byte; 
numeric variable, string variable 
[byte count] 



EXPLANATION 



Sets the array and string buffers to nulls and zeroes. 

Sets space for string variable to X characters (normally 50 characters). 

Continues execution after CTRL/J, ori'. 

Used in conjunction with READ to input data Into an executing program. 

Defines a user function to be used in the program. 

Reserves space for lists and tables according to subscripts specified after variable 
name. Up to 255 dimensions. 

Terminates program execution. 

Creates a new random file with the specified number of records (1-32767), record size 
(1-32767 bytes), and blocking factor (1-255). File name is a string expression contain- 
mg a valid FCS file name. 

Opens a random file with the specified file number (1-127) and number of buffers 
(1-255). 

Finds the specified attributes for the currently open file: current record accessed 
number of records, record size, and blocking factor. 

Closes the specified files and releases the buffer space. 

Writes any modified buffers immediately for the specified files. 

Causes file errors to trap to the specified line number. No line number turns the error 
trapping off. 

Lets the user determine the disk error number and location of the file error. 

Sets up a loop to be executed the specified number of times. 

Reads from the record in the file N starting at the specified first byte (1-255) into the 
variables in the list. String variables must have a byte count (1-255). 
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BASIC Statements (Cont.) 



COMMAND 



EXPLANATION 



i/gOSUB line number 
,/GOTO line number 

v/IF expression GOTO line number 
*/^ IF expression THEN statement 
</|NPUTIist 
'^INPUT"string";list 
^LIST 

uLIST line number 
LOAD "PRGRM1" 

LOAD "name.ARY" 

^N EXT variable 

/ON X GOSUB line number list 

v/ON X GOTO line number list 

^UTI.X 

\/PLOT expression 

vPLOT list 

v^POKE l,X 

/PRINT list 

^'RINT expression 

'^I'RINT expression, expression; 

PRINT "string" 

/? 

'^PRINT SPC (X) 

^PRINT TAB (X) 

'^PUT file N, record, first byte; 
numeric expr., string expr. 
[byte count] 

"^ READ variable list 

^REM comment 

^RESTORE 

'^RESTORE line number 



RETURN 

\/run 

v'ruN line number 
SAVE "PRGRM1" 
SAVE "name. ARY" 

-/wait X,I,J 



Used to transfer control to the first line of a subroutine. 

Used to unconditionally transfer control to other than the next sequential line in the 
program. 

Used to conditionally transfer control to the specified I Ine of the program. 

Used to execute BASICstatements only when expression Is true. 

Used to input data from the terminal keyboard, prompts with "?". 

Used to input data with the quoted string as the prompt. 

Prints the user program currently in memory on the CRT display. 

Prints the program from the line specified to the end. 

Loads a BASIC Program named "PRGRM1 " from disk into memory. Names cannot 
exceed six characters (letters and/or numbers). 

Loads the numeric array specified by name from disk. First two characters are the 
array's name. 

Placed at the end of a FOR loop to return control to the FOR statement. 

Multiple GOSUB statement. Will transfer control to subroutine on stated line. 
However, the RETURN statement placed at the end of each subroutine will cause the 
next statement following ON GOSUB to be executed. 

Multiple GOTO statement, will transfer control to stated line number, depending on 
value of variable. 

Causes the byte X to be output to port I (the range of I is to 255). 

Sends the one byte result of the expression to the terminal. The result must be 
between and 255. 

Sends the list of data to the CRT Example: PLOT 2, 242, 0, 0, 255. 

Causes the byte X to be placed In memory location I, the range of I Is to 65535. 

Used to output data to the terminal. 

Prints results of expression. 

The ; causes the carriage return and line feed to be suppressed. Use , for normal 
spacing and ; for compressed spacing. 

Prints a character string. 

Equivalentto the word PRINT. 

Prints the specified number of spaces. 

Used to space to the specified column. 

Writes the expressions in the list to the record In file N starting at the specified first 
byte. String expressions must have a byte count. 

Used to assign the values listed in a DATA statement to the specified variables. 

Used to insert explanatory comments Into a BASIC program. 

Used to reset the data block pointer so the same data can be used again. 

Used to reset the data block pointer to a specified line number. 

Used to return program control to the statement following last executed GOSUB 
statement. 

Executes the program In memory. 

Executes the program starting at line number specified. 

Saves the BASIC program or data from memory into the disk and names it "PRGRM1." 

Saves the numeric array specified by name on disk. First two characters are the 
array's name. 

Causes the input port X to be read, exclusive OR'ed with byte J, and then AND'ed with 
byte 1. The program will wait until the result is zero before continuing. 

A colon is used to separate multiple statements per line. 
Example 10A= 1:B = 10:0=111 
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BASIC Operators 



SYMBOL 


FUNCTION 


' 


Assignment, or equality test (DISK 
BASI C 8001 does not al low the LET 
statement) 


- 


Negation or subtraction 


+ 


Addition or string concatenation 


* 


Multiplication 


/ 


Division 


A 


Exponentiation 


NOT 


Logical or One's complement (2 byte 
integer) 


AND 


Logical or Bitwise AND (2 byte integer) 


OR 


Logical or Bitwise OR (2 byte integer) 


=. <, >, 
<=, = <, 
>=, = >, 
<> 


Relational tests (result is TRUE = - 1 
or FALSE = 0) 



The precedence of operators is: 



(1 ) Expressions in parentheses 

(2) Exponentiation (A '^ B) 

(3) Negation (-X) 
(4)*,/ 

(5)+,- 

(6) Relational operators (=, < >, <, >,<=,> =) 

(7) NOT 

(8) AND 

(9) OR 



Standard Mathematical Functions 

The Mathematical functions are of the following form: 1 0y = ABS (x). 



NAME 



EXPLANATION 



VABS(x) 
vATN(x) 
\eALL(x) 

/COS(x) 
\/feXP(x) 
^FNx(y) 
^FRE(x) 
V|NT(x) 

^NP(x) 
AOG(x) 

"PEEKCx) 
yPOS(x) 
VrND(x) 
n/SGN(x) 
VSIN(x) 
VSQRCx) 

vTAN(x) 



Returns the absolute value of X. 

Returns the arctangent of X as an angle in radians in the range + or- pi/2. Where pi = 3.14159. 

Call the user machine language routine at location 33282. D,E registers have value of X and A,B 
registers must have Yon return from machine language routine. 

Returns the cosine of X radians. 

Returns the value of eX where e = 2.71828. 

Returns the value of the user defined function x with argument y. 

Returns number of free bytes not in use. 

Returns the greatest integer less than or equal to x. 

Returns a byte from input port x. The range for x is to 255. 

Returns the natural logarithm of x. 

Returns a byte from memory address x. The range for x is to 65535. 

Returns a value to 63 of the print command column. 

Returns a random number between and 1 . 

Returns a value indicating the sign of x. 

Returns the sine of x radians. 

Returns the square root of x. 

Returns the tangent of x radians. 



Standard String Functions 

The string functions are of the following form A$ = CHR$(x) or A = ASC(x$) 



NAME 



/aSC(x$) 

/CHR$(x) 

>^FRE(x$) 

AeFT$(x$,I) 

AeN(x$) 

yMID$(x$,l,J) 

^/RIGHT$(x$,l) 

n/STR$(x) 

v/VAL(x$) 



EXPLANATION 



Returns as a decimal number the eight-bit internal code for the first character of string (x$). 

Generates a one-character string having the ASCI I value of x. 

Returns number of free string bytes. 

Returns left most I characters of string (x$). 

Returns the number of characters in the string (x$). 

Returns J characters of string (x$) starting at position I. 

Returns right most I characters of string {x$). 

Returns the string which represents the numeric value of x. 

Returns the number represented by the string (x$). 



12 



BASIC and FILE Error Codes 

After an error occurs, BASIC returns to command level and types READY. Variable values and the program text remain 
intact, but the program cannot be continued and all GOSUB and FOR context is lost. 

When an error occurs in a direct statement, no line number is printed. 

Format of error messages: 

Direct Statement XX ERROR 

Indirect Statement XX ERROR IN YYYYY 

In both of the above examples, "XX" will be the error code. The "YYYYY" will be the line number where the error occured 
for the indirect statement. 



The following are the possible error codes and their meanings: 



ERROR CODE MEANING 



BS Bad Subscript. An attempt was made to reference a matrix element which is outside the dimension of the 

matrix. This error can occur if the wrong number of dimensions are used in a matrix reference. For 
instance, A (1 ,1 ,1 ) = Z when A has been dimensioned DIM A(2,2). 

DO Double Dimension. After a matrix was dimensioned, another dimension statement for the same matrix 

was encountered. This error often occurs if a matrix has been given the default dimension 10 because a 
statement like A(l) = 3 is encountered and then later in the program a DIM A(1 00) is found. 

CF Call Function error. The parameter passed to a math or string function was out of range. CF errors can 

occur due to: 

a) A negative matrix subscript ( A(-1 )=0). 

b) An unreasonably large matrix subscript (>32767). 

c) LOG-negative or zero argument. 
d)SQR-negative argument. 

e) Af B with A negative and B not an integer. 

f) A CALL (X) before the address of the machine language subroutine has been patched in. 

g) Calls to MID$, LEFTS, RIGHTS, INP, OUT WAIT PEEK, POKE, TAB, SRC or ON . . . GOTO/GOSUB 
with an improper argument. 

ID Illegal Direct. You cannot use an INPUT or DEF statement as a direct command. 

NF NEXT without FOR. The variable in a NEXT statement corresponds to no previously executed FOR 

statement. 

CD Out of Data. A READ statement was executed but all of the DATA statements in the program have already 

been read. The program tried to read too much data or insufficient data was included in the program. 

OM Out of Memory. Program too large, too many variables, too many FOR loops, too many GOSUB's, too 

complicated an expression or any combination of the above. 

OV Overflow. The result of a calculation was too large to be represented in BASIC'S number format. If an 

underflow occurs, zero is given as the result and execution continues without any error message being 
printed. 

SN Syntax error. Missing parenthesis in an expression, illegal character in a line, incorrect punctuation, etc. 

RG RETURN without GOSUB. A RETURN statement was encountered without a previous GOSUB statement 

being executed. 

US Undefined Statement. An attempt was made to GOTO, GOSUB or THEN to a statement which does not 

exist. 

/O Division by Zero. 

CN Continue error. Attempt to continue a program when none exists, an error occurred, or after a new line 

was typed into the program. 

LS Long String. Attempt was made by use of the concatenation operator to create a string more than 255 

characters long. 

OS Out of String Space. Use the CLEAR X statement to allocate more string space or use smaller strings or 

fewer string variables. 

ST String Temporaries. A string expression was too complex. Break it into two or more shorter ones. 

SL SAVE/LOAD error. (From disk operation.) Other error messages may also appear from the FILE 

CONTROL SYSTEM (FCS). 

TM Type Mismatch. The left hand side of an assignment statement was a numeric variable and the right hand 

side was a string, or vice versa; or, a function which expected a string argument was given a numeric one 
or vice versa. 

UF Undefined Function. Reference was made to a user defined function which had never been defined. 
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BASIC and FILE Error Codes (Cont.) 



ERROR CODE 



ERROR 
NUMBER 



MEANING 



EV 




BF 


2 


NO 


4 


AO 


6 


FS 


8 


RO 


10 


EF 


12 


CO 


14 


CC 


16 


RE 


18 


WE 


20 



No error vector. 

Bad file name. 

File not open. 

File already open. 

File size error 

Record overflow. 

End of file. 

Can't open file (usually nonexistent file). 

Can't close file (usually hardware problem). 

FCS READ error (usually hardware problem). 

FCS WRITE error (usually hardware problem). 



3. FCS (File Control System) COMMANDS 

File Control System is entered by pressing (ESC), then D from the keyboard, or PLOT 27,4 from BASIC. 

(Only the first three letters of the command need to be typed in.) If (ESC), D is from the keyboard then BASIC is terminated 

and must be re-entered by (ESC), E key sequence. 

Statement Definitions 

The following definitions will be used to describe the FCS commands: 

( ) Means mandatory part. 

[ ] Means optional part and if not specified, will result in the default type. 

(Device name:) = [Device type] [Number] (:) 

Device types are CD, MD, and FD for Compucolor Disk, Mini-Disk, and 8" Floppy Disk and number is either or 1. 

(Memory spec) = (Load address) (Byte count) or (-End address) all memory addresses are in HEX format. 

(File spec) = (File name) [.Type] [;Version] 

File name is any 6 characters. Type can be any three characters and PRG is default type. Version is0 to FF HEX 
number 

NOTE: After a default device type has been selected only the number of the device is required. COMPUCOLOR II 
defaults to CD0. 

COMMANDS 



COPY [Device Name:] (File Spec) 

TO [Device Name:] (File Spec) 

DELETE [Device Name:] (File Spec] 

DEVICE [Device Name:] 

Y DIRECTORY [Device Name:] 

i) DUPLICATE (Device Name:) TO (Device 
\j Name:) 

1^ ExiT-^Q§;;___^____^ 

J . — -INITIALIZE [Device Name:] (Volume Name) 
xj No. OF DIR BLOCKS 

LOAD [Device Name:] (File Spec), 
Load Address 

READ [Device Name:] (Start Block No.) 
(Memory Spec) 

RENAME [Device Name:] (File Spec) 
TO (File Spec) 

RUN [Device Name:](File Spec) 

SAVE [Device Name:] (File Spec) 

(Memory Spec), Start Address, 
Actual Address 

WRITE [Device Name:] (Start Block 
No.) (Memory Spec) 



Will copy one file from one location to another location. 

All file spec options are required. Allows the user to delete any file. 

Sets and displays the current default device name. 

Lists directory of the default or specified device. 

Will duplicate all the files on the original diskette onto another diskette. 
(Requires two disk drives.) 

(ESC) and (ESC) again or (ESC) and E to return to BASIC. 

Number of directory blocks will default to a normally adequate no.; NOTE: 
device name requires all options. 

Loads memorywith a program. Defaults to LDA type files written by 
Compucolor II assembler 

Will read into memory from anywhere on the diskette starting at any block 
and ending where specified, without regard to program boundaries. 

Allows the user to rename any file to any other name. 

Loads and executes program by name; normally a PRG type file. 

Start address defaults to LOAD address and actual address defaults to load 
address. Saves memory as a PRG type default file. 

Same as READ but writes memory to diskette. WARNING: it is possible to 
destroy the FCS directory and file information on a diskette with this command. 
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FCS Err or Codes^ 

EBLF 

EBLK 

ECOP 

ECFB 

EDCS 

EDEL 

EDFN 

EDIR 

EDRF 

EDSY 

EDUP 

EFNF 

EFRD 

EFWR 

EHCS 

ElVC 

EIVF 

EIVD 

ElVP 



BAD LOAD FILE SPEC, 2 

INVALID BLOCK NUMBER, 2 

ERROR DURING COPY, 1 & 3 

CANT FIND BLOCK, 3 

DATA CRC ERROR, 3 

DELETE ERROR, 1 &3 

DUPLICATE FILE NAME, 2 

DIRECTORY ERROR, 1 & 2 

DIRECTORY FULL, 4 

DATA SYNC CHAR ERROR, 1 & 3 

ERROR DURING DUPLICATE, 1 & 3 

FILE NOT FOUND, 2 

FILE READ ERROR, 3 

FILE WRITE ERROR, 3 

HEADER CRC ERROR, 3 

INVALID COMMAND, 2 

INVALID FUNCTION, 2 

INVALID DEVICE, 2 

INVALID PARAMETERS, 2 



ElVU INVALID UNIT, 2 

EKBA KEYBOARD ABORT, 4 

EMDV MISSING DEVICE NAME, 2 

EWIEM MEMORY ERROR DURING READ, 4 

EMFN MISSING FILE NAME, 2 

EMVN MISSING VOLUME NAME, 2 

EMVR MISSING VERSION, 2 

ENSA NO START ADDRESS, 2 

ENVE NO VOLUME ENTRY IN DIRECTORY 5 

ERSZ FILE TOO LARGE TO READ INTO ALLOCATED 

MEMORY 2 &4 

ESIZ DEVICE SIZES NOT SAME, 1 

ESKF SEEK FAILURE, 1 

ESYN SYNTAX ERROR, 2 

EVFY VERIFY FAILURE DURING WRITE, 3 

EVOV VERSION NUMBER OVERFLOW, 4 

EWRF WRITE FAILURE, 3 

EWSF FILE TOO LARGE TO WRITE ON DISKETTE, 
2&4 



Descriptions of Solutions to FCS Errors 

1.) Mechanical Problem— Jammed READ/WRITE head, loose disk drive internal I/O connectors. Refer to Compucolor 

Maintenance Manual. 
2.) Invalid User Input— Incorrect entry from user Refer to FCS Commands, page 14. 
3.) Diskette Failure— Try a different diskette. 
4.) Error Message is self-explanatory. 

5.) Diskette Not Initialized— You need to initialize the diskette and possibly purchase a formatted Compucolor blank 
diskette. 



Section IV 

Software 



Available Software .... ,x. ^u , 

Compucolor II has an evergrowing library of software designed to challenge, stimulate, educate, and facilitate. Check your 
dealer for the latest available program diskettes. 

Precautions/storage ... x „ 

Each 5%" diskette comes in a folder. For extended media life of your diskette, we suggest the following procedures. 

1 .) Do not put fingers on the precision surface. 

2.) Insert the diskette carefully into the disk drive. 

3.) Keep the diskette far from magnetic fields which will erase the diskette. 

4.) Store the diskette in the jacket when not in use. 

5.) Handle the diskette with care. Bending and folding will damage it. 

6.) Diskettes are best stored at temperatures ranging from 10° to 52° C or 50° to 125° F 

7.)DonotleavedisketteindiskdrivewhileturningyourCompucolor llonoroff. ,..•.. 

Availability of Preformatted Diskettes— Diskettes are available at the rate of 2 diskettes for $19.95 and may be obtained from 
Compucolor Corporation or your local dealer. 

Precautions/Power Outages 

Your Compucolor II should not be operated during an electrical storm. Storms can cause power outages to your Compucolor 
II. If your machine has a power failure, all data and programs will be lost. If the disk drive is being used during power failure, 
the diskette may be damaged. 

Do not leave diskette in disk drive while turning your Compucolor 1 1 on or off. 
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Section V 

Bibliography 



Some introductory books on computers and programming available through your Compucolor dealer: 

COMPUCOLOR BASIC Manual 

AN INTRODUCTION TO MICROCOMPUTERS, 

Adam Osborne 

Volume 0: The Beginner's Book 
Volume 1 : Basic Concepts 

Basic BASIC, 

James S. Coan 

A Guided Tour of Computer Programming in BASIC, 

Thomas A. Dwyerand Michael S. Kaufman 

BASIC (New 2nd Edition), 
BobAlbrecht 

A Quick Look at BASIC, 

Donald D. Spencer 

My Computer Likes Me... When I Speak BASIC 
What to do After You Hit RETURN 

Fun with Computers and BASIC, 

Donald D. Spencer 

Also check these home-computer oriented magazines, each with its own flavor. 

BYTE, Creative Computing, Interface Age, Kilobaud, People's Computers, Personal Computing 



Section VI 



PORT ASSIGNMENTS 



PORT# 


I/O PORT ADDRESS 


Hex Dec 




- F 


TMS 5501 


10 - IF 


TMS5501 Duplicate Addresses 


20 - 5F 


Not assigned. 


60 -6F 


SMC 5027 


70 - 7F 


SMC 5027 Duplicate Addresses 


80 - FF 


Not assigned. 



PORTtt 



SMC 5027 CRT CHIP 



Hex Dec 

60—96 Load Register 0- Do n't Load 

61 — 97 Load Register 1— Don't Load 

62-98 Load Register 2— Don't Load 

63— 99 Load Registers— Don't Load 

64 — 1 00 Load Register 4 -Don't Load 

65—101 Load Registers— Don't Load 

66-102 Load Register 6-Roll Register* 

67 —103 Processor Load Command— Don't Use 

68 — 1 04 Read Cursor X Register 
69—105 Read Cursory Register 
6A — 106 Issue Reset Command— Don't Issue 
6B-107 Scroll up 1 line 
6C - 1 08 Load Cursor X Register 
6D — 1 09 Load Cursor Y Register 
6E-110 Load Start Timing— Don't Load 
6F —111 Self Load Command— Don't Use. 



PORTtt 


TMS 5501 I/O CHIP 


Hex 


Dec 







- 


Read Serial Data in from J-2. 


1 


- 1 


Read Parallel Data from Keyboard 
Connection J-1. 


2 


- 2 


Read Interrupt Address on TMS 5501. 


3 


- 3 


Read Status on TMS 5501 . 


4 


- 4 


Issue Discrete Command. 


b 


- 5 


Set Baud Rate on J-2 Serial I/O. 


b 


- 6 


Transmit Serial Data out to J-2. 


7 


- 7 


Transmit Parallel Data on Connection 
J-1 (also controls Disk R/W). 


b 


- 8 


Load Interrupt Mask Register. 


y 


- 9 


Interval Timer #1. 


A 


- 10 


Interval Timer #2. 


B 


- 11 


Interval Timer #3. 


C 


- 12 


Interval Timer #4. 


D 


- 13 


Interval Timer #5. 


E 


- 14 


No Function. 


F 


- 15 


No Function. 
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KEY MEMORY LOCATIONS 

28672 to 32767 = Screen refresh RAM. 

32940 = Points to maximum RAM used by BASIC. 
32980 = Points to start of source. 
32982 = Points to end of source and start of variables. 
32984 = Points to end of variables and start of arrays. 
32986 = Points to end of arrays. 

33209 = to 59 seconds of Real Time Clock. 

33210 = to 59 minutes of Real Time Clock. 

3321 1 = to 23 hours of Real Time Clock. 
33215 = User ESCAPE t jump vector. 
33218 = User output FLAG jump vector 
33221 = User input FLAG jump vector 
33224 = User timer no. 2 jump vector 
33238 = External output port buffer 
33247 - Keyboard FLAG. 

33249 = FCS output FLAG. 
33251 = Input port FLAG. 
33265 = BASIC output FLAG. 

33272 = Output port FLAG. 

33273 = LIST output FLAG. 

33278 = Keyboard character 

33279 = Keyboard character ready FLAG. 
33282 = Location of CALL(x) jump. 
33285 = BASIC output vector location. 
33289 = No. of characters on terminal output. 
33433 = Start of BASIC source code. 
65535 = Maximum amount of RAM. 



CHARACTER SET 

iSi 

Qasna 

SELBaBB 

HBHCB 
§0a][EC3 



/\ 



rn 



CD 
CD 






FIFTY PIN BUS 

(Preliminary, subject to change.) 



PIN DESIGNATION 



PIN DESIGNATION 



1 


+ 12V 


26 


D2BUS 


? 


MR 


27 


A2 


3 


MW 


28 


D3BUS 


4 


l/OW 


29 


A3 


5 


<1>2(+12V) 


30 


D7BUS 


6 


*2TTL 


31 


A4 


7 


01 (+12V) 


32 


D6BUS 


8 


17.9712MHz 


33 


D4BUS 


9 


SYNC 


34 


D5BUS 


10 


RESET 


35 


A6 


11 


-5V 


36 


D0 8080 


12 


+5V 


37 


A7 


13 


GND 


38 


D1 8080 


14 


I/OR 


39 


A8 


15 


A10 


40 


D2 8080 


16 


READY 


41 


A14 


17 


NO CONNECTION 


42 


D3 8080 


18 


NO CONNECTION 


43 


D4 8080 


19 


HOLD 


44 


A9 


20 


A5 


45 


A13 


21 


All 


46 


D7 8080 


22 


D0 BUS 


47 


A12 


23 


A0 


48 


A15 


24 


D1 BUS 


49 


D5 8080 


25 


A1 


50 


D6 8080 



RS 232C INTERFACE 



CPU EDGE 
CONNECTOR # 



RS232C 
PIN# 



SIGNAL NAME 
AND LINE 



1 


1 


AA Protective Ground 


3 


2 


BA Transmitted Data 


5 


3 


BB Received Data 


7 


4 


CA Request to Send 


14 


7 


AB Signal Ground 


15 


20 


CD Data Terminal Ready 



c 




r 



ji' 



1^1 



v^> 



Ed 



NJ. 



N 



20,21 U^^ 



5h 



CD 



r-^ 



s 



c 



3 



r 



"QDffl 



V. 



J 



/ 



l/\i 



\/. 



zs 











^^ 




7 


E,Z 


25^1 


z 




v.- 











K> 



^n; 






Z 



D 



/I 



C3 




E3 



A 



C,0 32,110 
32^3 



<3,43^- 



SZI 



za 



02 



PS 



/ 



"^ 











32.21 




^ 


U 


32,23 




J 


W 











sa 



ZH 



E3- 




T,U 27,4 



c 



L 



D 



U 



lo^U H-GZl^ 



Typical Graphic and Alphanumeric Displays 



COHPUCOLOR CORFflRflTIOII 
PR W M lUeS OF TIC PMOSH 1(01 l«T Rai fflE IH) Bi 

i - CanCOJDR IHQD 

t - aLK QURiics oisfuff U5DC fyrmc Hicnae 
2 - OBI) PRDffii! (smu msFuns I ecu Fsnue 
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Each diskette presents a "menu" of programs from whichi to choose. 




Card decks in two sizes can be generated on the Compucolor II. 





Test your luck against the Compucolor 1 1 slot machine. 



Colorful graphics add a new dimension to computer games. 




With plot mode and color, charts are easy to program and quickly 
understood. 





Converting to the metric system is a simple matter with 
Compucolor II. 
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